home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1994 December / SOFM_Dec1994.bin / mac / Desktop Publishing / EPS Fixer 1.2 / EPS Fixer Docs (Text) < prev    next >
Text File  |  1994-10-04  |  11KB  |  243 lines

  1. EPS Fixer Documentation
  2. ⌐ 1994 David C. Schooley
  3. This program is Shareware
  4.  
  5. What does it do?
  6. EPS Fixer is a small utility that allows you to view the PICT preview 
  7. resources that are present in most Macintosh EPSF (Encapsulated 
  8. PostScript) files. If for some reason no PICT resource is present, then 
  9. EPS Fixer will try to create one. Starting with version 1.1 of the 
  10. software, you can paste or drag pictures into EPS Fixer windows to create 
  11. a preview resource. As of version 1.2, EPS Fixer can read PICT files and 
  12. use the contents as the preview. EPS Fixer will also allow you to correct 
  13. any discrepancies between the boundary of the PICT preview and the 
  14. bounding box information within the PostScript data. Finally, EPS Fixer 
  15. can change the file types between ╘TEXT╒ and ╘EPSF╒ to simplify importing 
  16. EPSF files into word processing or desktop publishing programs.  These 
  17. options are described in greater detail below. 
  18.  
  19. New in Version 1.2:
  20. There is now a preferences option in the Edit menu. The preferences dialog 
  21. allows you to set the status window so that it does appear every time you 
  22. start the program. In addition, you can set the program to automatically 
  23. adjust either the PICT rectangle or the bounding box. There are also some 
  24. bug fixes in this version. For a complete listing of changes and bug fixes, 
  25. please see the file titled ╥Version History╙.
  26.  
  27. System Requirements:
  28. EPS Fixer requires a Macintosh running System 7.0 or later. EPS Fixer 
  29. supports Macintosh Drag and Drop and AppleScript. In addition, Balloon 
  30. Help is available for the various menu items. Version 1.2 includes an 
  31. Apple Guide, titled EPS Fixer Guide for users running System 7.5. If you 
  32. are using System 7.1 or earlier, you can delete this file.
  33. The archive you received should contain versions of the software for 68xxx 
  34. Macintoshes and Power Macintoshes. Simply delete the folder that does not 
  35. apply to your machine. I╒m distributing the code this way because some 
  36. people don╒t like fat binaries due to the extra disk space required. On 
  37. the other hand, some people like them because they run applications over a 
  38. network, or have PPC upgrade cards in their 68K Macs. If you would like a 
  39. fat binary version, please send me EMAIL. Or better yet, register the 
  40. software, and include a note saying that you would like a fat binary 
  41. version. I will EMAIL it to you.
  42.  
  43. Power Macintosh Notes:
  44. If you don╒t have it already, there is a version of EPS Fixer that runs in 
  45. native mode on Power Macs. To use this version, you must have the 
  46. ╥ObjectSupportLib╙ in your Extensions folder. This is a shared library 
  47. that is part of the AppleScript distribution that comes with your Power 
  48. Mac system software. The shared library is located in the following folder 
  49. if you are installing from the System 7.1 distribution: 
  50. Apple Extras:AppleScript 1.1:AppleScript¬Setup:Apple's Scripting 
  51. System:RISC Support
  52.  
  53. Background Information
  54. EPSF files are PostScript files that contain bounding box information that 
  55. a page layout program can use when importing the file. A valid EPSF file 
  56. must contain the following two lines:
  57.  
  58. %!PS-Adobe-3.0 EPSF-3.0
  59. %%%BoundingBox: 1 1 200 300
  60.  
  61. The numbers following "EPSF" and the bounding box may be different than
  62. that shown above. Besides the bounding box, these files may also contain 
  63. PostScript preview  information that can be used to display the file. This 
  64. PostScript preview is usually a bitmap written as text. EPSF files created 
  65. on a Macintosh can contain a ╘PICT╒ preview resource along with the PostScript preview. The  ╘PICT╒ preview allows a Macintosh program to rapidly display 
  66. the image without needing a PostScript interpreter.
  67.     Several people have asked me if EPS Fixer can convert normal PostScript 
  68. files to Encapsulated PostScript files. I am seriously looking at 
  69. incorporating this into the next version. It╒s not in this one, because I 
  70. wanted to get this out the door due to the bug fixes.
  71.  
  72. Viewing and Creating the PICT Resource
  73. When EPS Fixer opens an EPSF file, it will immediately try to display the 
  74. PICT resource. If no PICT resource is present, then the program will 
  75. attempt to create one by reading the PostScript preview data in the file. 
  76. If the PostScript information does not contain preview information in a 
  77. readable format, EPS Fixer will create a place-holder that has the proper 
  78. dimensions. Saving a file after displaying it will save the PICT resource 
  79. without modifying any of the PostScript information in the file.
  80.     Of the various types of PostScript previews within an EPSF file, the ones 
  81. that EPS Fixer can read are marked by the following strings:            
  82.     %%BeginPreview:                
  83.     %%Note: Object                
  84.     %%BeginBinary:
  85.  
  86. The three strings listed above denote three different preview formats. Of 
  87. these formats, the first is the one most likely to be handled correctly by 
  88. EPS Fixer. The other two are not strictly EPSF previews, but are used by 
  89. the PostScript interpreter when printing the file. If EPS Fixer finds a 
  90. preview that it cannot read, it will create a place-holder PICT resource. 
  91. The place-holder resource is simply a box containing the name of the EPSF 
  92. file.
  93.     EPS Fixer displays a floating status window that lists the coordinates of 
  94. the bounding box and the PICT preview for the frontmost window. This 
  95. status window also gives information on what EPS Fixer was able to 
  96. accomplish when it was reading the file.
  97.     Starting with version 1.2, EPS Fixer allows you to create a PICT preview 
  98. from an existing PICT file. To do this, open the EPS file, and then select 
  99. Insert PICT╔ from the File menu.
  100.  
  101. Fixing the Bounding Box
  102. Some Macintosh programs create EPSF files that have bounding boxes that do 
  103. not agree with the PICT resource they insert into the file. The menu items 
  104. under the ╥Fix╙ menu will correct this. The ╥Set Bounding Box to PICT╙ 
  105. menu item will set the bounding box coordinates to the PICT coordinates. 
  106. The ╥Set PICT to Bounding Box╙ item will adjust the PICT resource so that 
  107. it matches the bounding box.
  108.  
  109. Changing the File Type
  110. EPS Fixer will also change file types between ╘TEXT╒ and ╘EPSF╒. These 
  111. conversions are available in the file menu.
  112.  
  113. Drag and Drop Support
  114. EPS Fixer supports the Macintosh Drag Manager, which allows you to drag a 
  115. preview to a drag savvy application without using the clipboard. This will 
  116. work if you have installed the Macintosh Drag and Drop extension, or if 
  117. you are using System 7.5 or later. To drag a preview, click on the 
  118. picture, and without releasing the mouse button, drag the preview to the 
  119. Finder or to another application that supports Drag and Drop. In versions 
  120. 1.1 or later of EPS Fixer, you can drag a picture from another application 
  121. into an EPS Fixer window. This new picture will become the preview 
  122. resource. You may need to adjust the rectangle of the PICT resource to 
  123. match the bounding box. There are options in the ╥Fix╙ menu to do this.
  124. Note: Although SimpleText can display normal PICT files and supports Drag 
  125. and Drop, it won╒t let you drag a PICT file. I am mentioning this because 
  126. at least one user has tried it.
  127.  
  128. AppleScript Support
  129. The program is also somewhat scriptable.  An AppleScript ╥droplet╙ is 
  130. included in the distribution. This droplet allows you to create the 
  131. preview resource without explicitly opening and saving the EPSF file. If 
  132. you drop a group of files on the droplet, EPS Fixer will process each file 
  133. in turn. The first time you use this droplet, it may ask for the location 
  134. of EPS Fixer. After it has found it once, it should not need to do so 
  135. again.
  136.  
  137. Limitations
  138. EPS Fixer will correctly display color PICT previews, but will not create 
  139. them. 
  140.  
  141. Future Plans
  142. These depend on the shareware response. If you like the software, and send 
  143. me suggestions, I will try to implement them. Next on the list is to add 
  144. color support when creating the PICT previews. As stated earlier, if a 
  145. color PICT already exists, the program will display it correctly. However, 
  146. EPS Fixer cannot create them yet.  
  147.  
  148. I would also like to add more AppleScript support. 
  149.  
  150. Acknowledgements, etc╔
  151. I wrote this program using Metrowerks╒ CodeWarrior C++ compiler and the 
  152. PowerPlant class library. PowerPlant made including the support for both 
  153. AppleScript and Drag and Drop unbelievably painless.
  154.  
  155. CodeWarrior and PowerPlant are trademarks of Metroworks Inc.
  156.  
  157. PostScript¬ is a trademark of Adobe Systems Inc.
  158.  
  159. AppleScript¬ is a trademark of Apple Computer
  160.  
  161.  
  162. Shareware Information
  163. If you decide to use this software for more than 30 days, please pay me 
  164. for it. Single machine licenses are $10. Site licenses are available at a 
  165. cost of $10 for the first machine, $7 for each machine thereafter. Please 
  166. contact me if you would like a site license. We can probably work 
  167. something out. Upgrades, if there are any, are free. You can use the form 
  168. at the end of this documentation to register. Please include any changes 
  169. or enhancements you would like to see in the next version of the software. 
  170. If you choose not to register, please let me know why.
  171.     Please register if you haven╒t already.
  172.  
  173. Legal Stuff
  174. This software is ⌐1994 by David C. Schooley. 
  175.  
  176. This software is offered as is. The author makes no warranty regarding the 
  177. usefulness or usability of this software. The liability of the author for 
  178. any damages resulting from the use of this software is limited to the 
  179. registration cost of one copy of the software, regardless of the form of 
  180. the claim. The author accepts no liability whatsoever if the shareware fee 
  181. has not been paid.
  182.  
  183. Please copy and distribute this software by way of every method possible. 
  184. However you must:
  185.     Keep the program and its accompanying documentation and auxiliary files 
  186. together.
  187.     Obtain written permission from the author if any fee is to be charged for 
  188. the distribution of this software.  You may also obtain permission via 
  189. EMAIL.
  190.  
  191. Contacting the author:
  192.  
  193. Please submit bug reports, feature requests, etc╔, to
  194.  
  195. EMAIL:
  196.     INTERNET: schooley@ee.gatech.edu
  197.     America Online: DSchooley
  198.  
  199. Snail Mail:
  200.     David Schooley
  201.     200 26th St. NW. N-203
  202.     Atlanta, GA 30309
  203.  
  204.  
  205. EPS Fixer Registration Form
  206.  
  207. Name:    ___________________________________________________
  208.  
  209. Mailing Address:    ___________________________________________
  210.  
  211.             ______________________________________________________
  212.             
  213.             ______________________________________________________
  214.  
  215.             Country:    ____________________________________
  216.  
  217. EMAIL:    ____________________________________________________
  218.  
  219. Where you obtained this software:      _____________________________
  220.  
  221.             ______________________________________________________
  222.  
  223.  
  224. Fees:        Single Machine License:                   $10.00
  225.             Additional Licenses: (__ @$7.00 each)    _______
  226.             Georgia Residents add 6% sales tax            _______
  227.             Total Amount Due:                                                                _______
  228.  
  229. Fees may be paid by cash, check, or money order payable in U.S. currency. 
  230. Checks must be drawn on U.S. bank in U.S. dollars.
  231.  
  232. Suggestions/Comments:    ____________________________________
  233.         ____________________________________________________
  234.         ____________________________________________________
  235.         ____________________________________________________
  236.         ____________________________________________________
  237.         ____________________________________________________
  238.  
  239. Send this form to:
  240.     David Schooley
  241.     200 26th St. N.W. N-203
  242.     Atlanta, GA 30309
  243.     USA